home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_MAN / IMP_STL.MAN < prev    next >
Encoding:
Text File  |  1996-06-13  |  5.6 KB  |  131 lines
  1.  
  2.  
  3. Import-STL()               Unix Programmer's Manual               Import-STL()
  4.  
  5.  
  6. NAME
  7.      imp_stl - StereoLithography STL geometry import filter
  8.  
  9. SYNOPSIS
  10.  
  11.      This man page describes the options specific to the StereoLithography STL
  12.      geometry import converter.
  13.  
  14. EXAMPLE CONVERSION SYNTAX
  15.  
  16.      To convert a StereoLithography STL file to Wavefront  using  the  default
  17.      parameters listed in the setup.ini file:
  18.  
  19.           pt -i stl -o wave filename.stl
  20.  
  21.      To convert a StereoLithography STL file to VRML and override some of  the
  22.      default options in setup.ini:
  23.  
  24.           pt -i stl -in-stl-flip-axes = yes -o vrml filename.stl
  25.  
  26. OVERVIEW
  27.  
  28.      This geometry import converter reads both binary and  ASCII  versions  of
  29.      StereoLithography  STL  files  which  are  typically  sent to 3D System's
  30.      StereoLithography molding machine. All triangles are read into  a  single
  31.      object since there is no object information contained within a .stl file.
  32.  
  33. COMMAND LINE OPTIONS
  34.  
  35.      The following options are specific to this import converter:
  36.  
  37.      -i stl
  38.           This is the optional command line option which  specifies  that  the
  39.           input  data  is  in  the StereoLithography STL file format (ASCII or
  40.           binary). If not specified then the converter will try to  guess  the
  41.           input file's format from its file extension (.stl) and then from the
  42.           contents of its file.
  43.  
  44.      -in-stl-report-statistics = [ yes | no ]
  45.           If this option is enabled then the import converter will  print  out
  46.           the number of objects and polygons that were parsed from the file.
  47.  
  48.      -in-stl-weld-vertices = [ yes | no ]
  49.           Polygons read in  from  a  .stl  file  are,  by  nature,  completely
  50.           separate  from  each  other  and  do  not share vertices even if two
  51.           adjacent  polygons  are  situated  side  by  side.  This  is   quite
  52.           inefficient  and  also  it  will  not  allow  the  .stl  data  to be
  53.           "smoothed" out  using  the  smoothing  option  described  below.  To
  54.           overcome  these problems the "Welding" option can be enabled. Vertex
  55.           welding collapses adjacent vertices which are within a distance less
  56.           than  or  equal  to the threshold value specified with the '-in-stl-
  57.           vertices-threshold'  option.   This  welding  operation  should   be
  58.           performed  if  the  "-in-stl-compute-normals"  option (see below) is
  59.           enabled. Also, the welding  operation  can  become  quite  slow  for
  60.           objects  with  large  number  of vertices since every vertex must be
  61.           compared against every other vertex  (an  n-squared  problem).  This
  62.  
  63.  
  64.                                                                              1
  65.  
  66.  
  67.  
  68. Import-STL()               Unix Programmer's Manual               Import-STL()
  69.  
  70.  
  71.           option is enabled by default.
  72.  
  73.      -in-stl-vertices-threshold = <threshold value>
  74.           If the distance between two vertices is less than or equal  to  this
  75.           number,  and  the "-in-stl-weld-vertices" option is enabled then the
  76.           two vertices will be collapsed (welded) into one. Since no edge in a
  77.           .stl  file  should  be shorter than 0.00015 units, the minimum value
  78.           for this threshold value should be set  to  0.00015  (which  is  the
  79.           default).
  80.  
  81.      -in-stl-compute-normals = [ yes | no ]
  82.           All .stl files do not contain vertex normals and thus will not  look
  83.           smooth  when  shaded. This option, when enabled, will allow smoothed
  84.           vertex normals to be computed  for  the  data  based  on  the  angle
  85.           between  adjacent  polygons. The smoothing criterion is based on the
  86.           angle between adjacent polygons; common smoothed vertex normals will
  87.           be computed if the angle between their geometric surfaces normals is
  88.           less than  the  "-in-stl-smoothing-angle"  type-in  value  described
  89.           below.  If this checkbox is disabled then no new vertex normals will
  90.           be created. NOTE: for this option to work properly  the  input  data
  91.           must  have  its  vertices  welded together so that adjacent polygons
  92.           share the same vertices (the "-in-stl-weld-vertices" option must  be
  93.           enabled. This option is enabled by default.
  94.  
  95.      -in-stl-smoothing-angle = <smoothing angle in degrees>
  96.           This type-in value sets the cut-off  smoothing  angle  (in  degrees)
  97.           used  by  the  vertex  normal  computation  algorithm.  If the angle
  98.           between two adjacent polygons is greater than this  number  then  no
  99.           smoothing  will  occur  (a  crease  will  be evident between the two
  100.           polygons), else smoothing will occur where the  polygons  meet.  The
  101.           default  angle  is  45  degrees; higher values will make the surface
  102.           smoother.
  103.  
  104.      -in-stl-flip-axes = [ yes | no ]
  105.           If this option is enabled then the model  will  be  reorientated  so
  106.           that  the "Up" axis of the model will be aligned with the positive Y
  107.           axis (which is used by the converter) instead of  the  positive  "Z"
  108.           axis  as  used  by  .stl  files.  This  option  should be enabled by
  109.           default.
  110.  
  111.      -in-stl-reverse-poly-orientation = [ yes | no ]
  112.           If this option is enabled then the orientation of each polygon  will
  113.           be  reversed  so  that  the  polygons' normals point in the opposite
  114.           direction. By default this option is disabled ('no').
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                              2
  130.  
  131.